﻿using System;
using System.Collections.Generic;
using System.Text;
using System.Net.Sockets;

namespace Sofire.DataComm.Net
{
    /// <summary>
    /// 表示异步发送的 <see cref="System.IAsyncResult.AsyncState"/> 用户自定义数据。
    /// </summary>
    public class SendStateObject : SocketStateObjectBase
    {
        /// <summary>
        /// 设置或获取一个值，指示当注册了 <see cref="Sofire.DataComm.Net.SendStateObject.Sent"/> 事件后，是否触发源头 <see cref="Sofire.DataComm.Net.SocketBase.Sent"/> 事件。默认为 false，表示不触发源头事件。
        /// </summary>
        public bool RaiseSourceSentEvent = false;

        /// <summary>
        /// 当前可靠的套接字发送完整数据后发生。
        /// </summary>
        public event SentEventHandler Sent;

        /// <summary>
        /// 初始化 <see cref="Sofire.DataComm.Net.SendStateObject"/> 的新实例。
        /// </summary>
        /// <param name="remoteSocket">接收字节数据的 <see cref="System.Net.Sockets.Socket"/>。</param>
        /// <param name="data">发送的数据。</param>
        public SendStateObject(Socket remoteSocket, byte[] data)
            : this(remoteSocket, data, null) { }

        /// <summary>
        /// 初始化 <see cref="Sofire.DataComm.Net.SendStateObject"/> 的新实例。
        /// </summary>
        /// <param name="remoteSocket">接收字节数据的 <see cref="System.Net.Sockets.Socket"/>。</param>
        /// <param name="data">发送的数据。</param>
        /// <param name="tag">用户自定义数据。</param>
        public SendStateObject(Socket remoteSocket, byte[] data, object tag)
            : base(remoteSocket)
        {
            if(data == null) throw new ArgumentNullException("data");
            this.Buffer = data;
            this.Tag = tag;
        }

        /// <summary>
        /// 可靠的套接字发送完整数据后发生。
        /// </summary>
        /// <param name="sentLength">获取发送数据的字节长度。</param>
        /// <param name="exception">表示发送的异常信息。可以为 null 值，表示这是一个成功的发送结果。</param>
        /// <returns>返回一个值，指示是否引发源头的事件。如果返回 true，则表示需要触发源头的事件。</returns>
        public bool RaiseSent(int sentLength, Exception exception)
        {
            if(this.Sent != null)
            {
                this.Sent(this, new SentEventArgs(this.RemoteSocket, sentLength, this.Tag, exception));
                return this.RaiseSourceSentEvent;
            }
            return true;

        }
    }
}
